home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor1 / cw.doc < prev    next >
Text File  |  1995-03-31  |  6KB  |  116 lines
  1. CW: A Morse Code Practice Program for the HP-48SX 
  2. by ? 
  3.  
  4. CW is a directory containing several programs and variables which 
  5. comprise a capable Morse code practice system for the user.  The 
  6. program can send code using the beeper at speeds slightly over 20 
  7. words per minute continuously, without encountering delays due to 
  8. calculator "garbage collection".  The user can set the overall 
  9. speed and element speed independently, or can manually set the 
  10. timing and delay for each element type.  The program will create, 
  11. send, and display five character random code groups, or the user 
  12. can store any size string in a variable to be sent and displayed 
  13. manually.  The following descriptions explain the programs and 
  14. variables and their use. 
  15.  
  16. CGR (Code GRoups) is a program which creates a string of 25 five 
  17. character random groups, sends them using the present speed 
  18. parameters, and then displays them so the user can check his 
  19. copy.  The characters are selected from a string in CGR 
  20. which contains all the characters and prosigns used in amateur 
  21. radio license tests.  If the user wishes to practice only certain 
  22. characters, this string can be changed with 'CGR' RCL EDIT or 'CGR' 
  23. VISIT and the groups will then include only the characters from 
  24. the modified string. 
  25.  
  26. SPD (SPeeD) is a program which calculates and sets the various 
  27. parameters affecting the timing of each type of element.  The 
  28. program prompts the user for the overall speed in words per 
  29. minute and the element speed, also in words per minute.  After 
  30. entering these two numbers on the stack, the user presses [LSHFT] 
  31. CONT and the program stores values in ST, LT, ET, CT, and WT. 
  32. SPD will not signal an error if speeds are set too high or if 
  33. element speed is less than overall speed, but one of the values 
  34. in ST, LT, etc. will be set to zero or negative and CWO will halt 
  35. or hang.  Calculator speed and overhead as well as time to do 
  36. the garbage collect operation limit the speed to slightly more 
  37. than 20 wpm if overall and element speeds are the same.  If 
  38. the element speed is set faster than the overall speed, somewhat 
  39. higher speeds can be reached, 26 wpm overall with 29 wpm element 
  40. speed being about the maximum in any case.  The speed will be 
  41. quite accurate, within 1% or so in most cases.  The user can 
  42. measure the speed if desired by storing the string 
  43. "paris paris paris ..." in TXT and using a stopwatch to time from 
  44. the first element of a word to the same first element a few words 
  45. later.  Divide the number of words timed by the number of seconds 
  46. on the stopwatch and then multiply that by 60 to obtain the speed 
  47. in words per minute. 
  48.  
  49. CWO (CW Output) is the program which actually sends the Morse 
  50. code using the beeper.  CWO sends the characters contained in the 
  51. string TXT.  TXT is set and CWO is called automatically by the 
  52. CGR program, but the user can set TXT and then execute CWO 
  53. manually to practice something other than random code groups. 
  54.  
  55. DSP (DiSPlay) is a program which display a screenful of 
  56. characters from the TXT string.  CGR calls this program to 
  57. display the code groups it creates and sends.  If TXT is more 
  58. than one screen long, DSP halts after each successive screen. 
  59. The user can view the next screen by pressing [LSHFT] CONT. 
  60.  
  61. TXT (TeXT) is a variable which contains a string which will 
  62. be sent as Morse code by the CWO program.  Any ACSII character 
  63. with decimal code 32 through 128 can be contained in TXT. 
  64. Characters that have no representation in Morse code will be 
  65. sent as a space.  Note that some of the radio prosigns which 
  66. have no representation in ASCII have been placed on some of 
  67. those characters.  For a listing of these, see the CODE 
  68. variable.  Note that lower case characters are folded into 
  69. upper case. 
  70.  
  71. CODE (CODE) is a variable which contains a list of short 
  72. programs, one for each character.  CWO disassembles this list 
  73. on the stack before sending so that it can access the 
  74. character codes much more quickly than by other methods. 
  75. Prosigns which have no associated ASCII character are rather 
  76. arbitrarily placed on the following characters: 
  77.      understood (SN)           ! 
  78.      error (HH)                # 
  79.      paragraph (AL)            * 
  80.      starting signal (KA)      [ 
  81.      wait (AS)                 \ 
  82.      end of work (SK)          ] 
  83.  
  84. ST (Short Time) is a numeric variable containing the basic 
  85. element (dit) time in seconds, normally set at 1.2/WPM. 
  86.  
  87. LT (Long Time) is a numeric variable containing the longer 
  88. element (dah) time, set at 3*ST. 
  89.  
  90. ET (interElement Time) is a numeric variable containing the 
  91. delay time between elements.  This is generally set at the 
  92. same value as ST, less the calculator overhead time between 
  93. elements, .04 sec. 
  94.  
  95. CT (Character Time) is a numeric variable containing the 
  96. delay time between characters.  This is usually set to the 
  97. same value as LT, adjusted for various calculator overhead 
  98. times in the program. 
  99.  
  100. WT (Word Time) is a numeric variable containing the delay 
  101. time between words.  This is normally set to 7*ST, adjusted 
  102. for various calculator overhead delays. 
  103.  
  104. FR (FRequency) is the frequency in hertz of the beeper. 
  105. Set at 500 hertz, but the user may store any value which 
  106. suits individual taste. 
  107.  
  108. S (Short beep) is a program which actually sends a single 
  109. dit element.  The user will not use this program. 
  110.  
  111. L (Long beep) is a program which actually sends a single 
  112. dah element.  The user will not use this program. 
  113.  
  114. W (Word wait) is a program which generates the delay for 
  115. a space character.  The user will not use this program. 
  116.